@ GNU AS assembler header file for StringSet
@ Written by DefMod (Dec  9 2012) on Sun Dec  9 15:50:30 2012
@ Jonathan Coxhead, jonathan@doves.demon.co.uk, 5 Sept 1995

@ OSLib---efficient, type-safe, transparent, extensible,
@ register-safe API coverage of RISC OS
@ 
@ Copyright (c) 1994-2012 Jonathan Coxhead and OSLib maintainers
@ 
@ Licence:
@ 
@    OSLib is free software; you can redistribute it and/or modify
@ it under the terms of the GNU General Public License as published by
@ the Free Software Foundation; either version 1, or (at your option)
@ any later version - and this with the following clarification and
@ special exception:
@ 
@    Linking this library statically or dynamically with other modules
@ is making a combined work based on this library. Thus, the terms
@ and conditions of the GNU General Public License cover the whole
@ combination.
@ 
@    As a special exception, the copyright holders of this library
@ give you permission to link this library with independent modules
@ to produce an executable, regardless of the license terms of these
@ independent modules, and to copy and distribute the resulting
@ executable under terms of your choice, provided that you also meet,
@ for each linked independent module, the terms and conditions of the
@ license of that module. An independent module is a module which is
@ not derived from or based on this library. If you modify this
@ library, you may extend this exception to your version of the library,
@ but you are not obliged to do so. If you do not wish to do so, delete
@ this exception statement from your version.
@ 
@    OSLib is distributed in the hope that it will be useful,
@ but WITHOUT ANY WARRANTY; without even the implied warranty of
@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
@ GNU General Public License for more details.
@ 
@    You should have received a copy of the GNU General Public License
@ along with this programme; if not, write to the Free Software
@ Foundation, Inc, 675 Mass Ave, Cambridge, MA 02139, USA.

#ifndef StringSet_Hdr
#  define StringSet_Hdr

#  ifndef Get_Types
#    define Get_Types
#    include "oslib/Types.Hdr"
#  endif

#  ifndef Get_Toolbox
#    define Get_Toolbox
#    include "oslib/Toolbox.Hdr"
#  endif

#  ifndef Get_Gadget
#    define Get_Gadget
#    include "oslib/Gadget.Hdr"
#  endif

@Symbols for constants
#  define Class_StringSet 0x380
#  define StringSet_GenerateUserValueChanged 0x1
#  define StringSet_GenerateSetValueChanged 0x2
#  define StringSet_Writable 0x4
#  define StringSet_GenerateAboutToBeShown 0x8
#  define StringSet_NoDisplay 0x10
#  define StringSet_Justification 0x60
#  define StringSet_JustificationShift 0x5
#  define StringSet_JustificationLeft 0x0
#  define StringSet_JustificationRight 0x1
#  define StringSet_JustificationCentred 0x2
#  define StringSet_GetAlphanumericField 0x1
#  define StringSet_GetPopUpMenu 0x2
#  define Action_StringSetValueChanged 0x8288e
#  define Action_StringSetAboutToBeShown 0x8288f
#  define StringSet_ValueTooLong 0x1

@Symbols for structure offsets and sizes
        .struct 0
StringSet_Gadget_string_set    : .skip   Toolbox_MsgReference
StringSet_Gadget_title         : .skip   Toolbox_MsgReference
StringSet_Gadget_initial_selected_string: .skip   Toolbox_MsgReference
StringSet_Gadget_selected_string_limit: .skip   Int
StringSet_Gadget_allowable     : .skip   Toolbox_MsgReference
StringSet_Gadget_allowable_limit: .skip   Int
StringSet_Gadget_prev          : .skip   Toolbox_C
StringSet_Gadget_next          : .skip   Toolbox_C
StringSet_Gadget               : 

        .struct 0
        Gadget_Object_MEMBERS StringSet_Object
StringSet_Object_string_set    : .skip   Toolbox_MsgReference
StringSet_Object_title         : .skip   Toolbox_MsgReference
StringSet_Object_initial_selected_string: .skip   Toolbox_MsgReference
StringSet_Object_selected_string_limit: .skip   Int
StringSet_Object_allowable     : .skip   Toolbox_MsgReference
StringSet_Object_allowable_limit: .skip   Int
StringSet_Object_prev          : .skip   Toolbox_C
StringSet_Object_next          : .skip   Toolbox_C
StringSet_Object               : 

        .struct 0
StringSet_ActionValueChanged_value: .skip   216*Char
StringSet_ActionValueChanged   : 

        .struct 0
        Toolbox_ActionHeader_MEMBERS StringSet_ActionValueChangedBlock
StringSet_ActionValueChangedBlock_value: .skip   216*Char
StringSet_ActionValueChangedBlock: 

        .struct 0
        .skip   Toolbox_ActionHeaderBase
StringSet_ActionAboutToBeShownBlock: 


@Symbols for SWI's and SWI reason codes
#  define StringSet_SetAvailable 0x380
   @Entry
   @  R0 = flags (Bits)
   @  R1 = window (Toolbox_O)
   @  R2 = &380
   @  R3 = string_set (Toolbox_C)
   @  R4 -> set (String)

#  define StringSet_SetSelected 0x382

#  define StringSet_SetSelectedString 0x0
   @Entry
   @  R0 = &0 :OR: flags (Bits)
   @  R1 = window (Toolbox_O)
   @  R2 = &382
   @  R3 = string_set (Toolbox_C)
   @  R4 -> selection (String)

#  define StringSet_SetSelectedIndex 0x1
   @Entry
   @  R0 = &1 :OR: flags (Bits)
   @  R1 = window (Toolbox_O)
   @  R2 = &382
   @  R3 = string_set (Toolbox_C)
   @  R4 = index (Int)

#  define StringSet_GetSelected 0x383

#  define StringSet_GetSelectedString 0x0
   @Entry
   @  R0 = &0 :OR: flags (Bits)
   @  R1 = window (Toolbox_O)
   @  R2 = &383
   @  R3 = string_set (Toolbox_C)
   @  R4 = buffer (pointer to String)
   @  R5 = size (Int)
   @Exit
   @  R5 = used (Int)

#  define StringSet_GetSelectedIndex 0x1
   @Entry
   @  R0 = &1 :OR: flags (Bits)
   @  R1 = window (Toolbox_O)
   @  R2 = &383
   @  R3 = string_set (Toolbox_C)
   @Exit
   @  R0 = index (Int)

#  define StringSet_SetAllowable 0x384
   @Entry
   @  R0 = flags (Bits)
   @  R1 = window (Toolbox_O)
   @  R2 = &384
   @  R3 = string_set (Toolbox_C)
   @  R4 -> allowable (String)

#  define StringSet_GetComponents 0x386
   @Entry
   @  R0 = flags (Bits)
   @  R1 = window (Toolbox_O)
   @  R2 = &386
   @  R3 = string_set (Toolbox_C)
   @Exit
   @  R0 = alphanumeric_field (Toolbox_C)
   @  R1 = popup_menu (Toolbox_C)

#endif
